Skip to content

Do not include web fonts in javadoc jar#1619

Open
hankem wants to merge 1 commit into
mainfrom
no-fonts-in-javadoc
Open

Do not include web fonts in javadoc jar#1619
hankem wants to merge 1 commit into
mainfrom
no-fonts-in-javadoc

Conversation

@hankem

@hankem hankem commented May 17, 2026

Copy link
Copy Markdown
Member

Commit 912abfd advanced maxSupportedJavaVersion, which is also used as languageVersion for the javadocTool, from Java 21 to Java 25.

Unlike javadoc 21, javadoc 25 by default includes ~4 MB of fonts in every *-javadoc.jar:
javadoc --no-fonts reduces the total size of published *-javadoc.jars by a factor of ~10, e.g.

  • archunit-javadoc.jar from 5.4 MiB to 1.6 MiB (was 1.4 MiB with javadoc 21)
  • archunit-junit5-api-javadoc.jar from 4.0 MiB to 0.1 MiB (was 0.1 MiB with javadoc 21)

@hankem hankem force-pushed the no-fonts-in-javadoc branch from 8724d40 to 122ac38 Compare May 17, 2026 19:58
javadoc {
options.addBooleanOption('html5', true)
} No newline at end of file
options.addBooleanOption("-no-fonts", true)

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you check that this works? I think the option should be --no-fonts (two dashes), see e.g. https://github.com/apache/maven-javadoc-plugin/pull/1309/changes

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, for sure. 🙂

With addBooleanOption("--no-fonts", true),

./gradlew javadoc

fails with

> Task :archunit:javadoc FAILED
error: invalid flag: ---no-fonts
Did you mean: --no-fonts
For more details on available options, use --help or --help-extra
1 error

Commit 912abfd advanced `maxSupportedJavaVersion`,
which is also used as `languageVersion` for the `javadocTool`, from Java 21 to Java 25.

Unlike javadoc 21, javadoc 25 by default includes ~4 MB of fonts in every `*-javadoc.jar`:
`javadoc --no-fonts` reduces the total size of published `*-javadoc.jar`s by a factor of ~10,
e.g.
- `archunit-javadoc.jar` from 5.4 MiB to 1.6 MiB (was 1.4 MiB with javadoc 21)
- `archunit-junit5-api-javadoc.jar` from 4.0 MiB to 0.1 MiB (was 0.1 MiB with javadoc 21)

Signed-off-by: Manfred Hanke <Manfred.Hanke@tngtech.com>
@hankem hankem force-pushed the no-fonts-in-javadoc branch from 122ac38 to 8e50b15 Compare June 19, 2026 10:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants